home *** CD-ROM | disk | FTP | other *** search
/ Power Programmierung / Power-Programmierung (Tewi)(1994).iso / magazine / pcmagazi / 1989 / 18 / menu.doc < prev    next >
Text File  |  1989-09-19  |  6KB  |  117 lines
  1. Command
  2.  
  3. Ron Smith October 31, 1989 (Utilities)
  4.  
  5.  
  6. Purpose:Combines information from full-screen displays and user keyboard input
  7.         to create batch and other program input files under the control of a
  8.         template file. Full screen editing facilities are provided for displays
  9.         of up to 300 lines and up to 100 input fields.
  10.  
  11. Format:MENU [/D/E/N] screen template out1 [out2 ...]
  12.  
  13. Remarks:The screen operand is the file containing the display.  A screen file
  14.         is created by entering MENU /E ,, screen and can later be edited by
  15.         entering MENU /E screen,, screen.  The commas are used to replace
  16.         omitted file operands.
  17.  
  18.            The template is a file that controls the format of the output files.
  19.         A template file is created with any ASCII text editor and contains
  20.         constant data and instructions for copying information entered on the
  21.         display.
  22.  
  23.     The out files are constructed from the information on the display and
  24.         in the template files.  Up to 64 out files may be created.
  25.  
  26.     The optional /D switch is used to display any screen or other ASCII file
  27.         of up to 300 lines.  If the screen file is not specified the DOS
  28.         standard input file is assumed.  The number of screen columns and rows
  29.         is automatically determined and all sizes of displays up to 255 x 255
  30.         are supported.
  31.  
  32.     The /N (No-restore) option is used to inhibit MENU from saving/restoring
  33.         the original DOS screen contents when exiting.  This switch is normally
  34.         invoked when loading programs that paint their own opening screen.
  35.  
  36. Template File:    The template file contains the instructions for creating the
  37.                 output files.  Each character in the template file is copied
  38.                 directly to the current output file (initially out1) except for
  39.                 the following editing characters.
  40.  
  41. [    Start pattern replacement.  If the form is used,information is extracted
  42.         from the nnn th input field on the display according to the following
  43.         pattern characters.
  44. ]    Copy the rest of the input field.
  45. ?    Copy the next character from the input field.
  46. =    Copy the rest of the current display line of the input field.
  47. |    Skip to the ], ignoring the rest of the pattern if there are no more
  48.         characters in the input field.
  49. \    Copy the next pattern character even if it is one of the above.
  50.  
  51. All other characters in the pattern are copied without change.  If anything 
  52. other than a decimal number follows the [, time and date substitution is 
  53. performed.  All characters except the following pattern characters are copied
  54. directly to the output file.
  55.  
  56. \    Copy the next character even if a pattern character.
  57. ]    Terminate pattern processing.
  58. MM    Insert the current month (01 to 12).
  59. DD    Insert the current day (01 to 31).
  60. CC    Insert the current century (19 or 20).
  61. YY    Insert the current year (00 to 99).
  62. MN    Insert the 3-character month abbreviation.
  63. DW    Insert the 3-character day-of-week abbreviation.
  64. hh    Insert the current hour (00 to 23).
  65. mm    Insert the current minute (00 to 59).
  66. ss    Insert the current second (00 to 59).
  67.  
  68. {    Copy information from a constant field on the display to the output 
  69.         file.  If the form {nnn} is used, the nnn th constant field is copied.
  70.         If the form {nnn} is used, the nnn th input field is assumed to be a
  71.         decimal number and that number selects the constant field.  For example,
  72.         {[1]} will extract the value in the first input field.  If that value
  73.         is 5, the fifth constant field is used.
  74. <    Select a new output file.  The form is nnn.  All further output will be
  75.         sent to the nnnth output file.  All output files remain open until the
  76.         end of processing so you may switch back and forth among them.
  77. \    Send the next character from the template file to the output file even
  78.         if it one of the above control characters.
  79.  
  80. Menu Keys: During display editing certain keys have a special effect.  The 
  81.            cursor arrow keys including Pg Up, Pg Dn, Backspace, and Del operate
  82.            normally, save that MENU always tries to place the cursor in an input
  83.            field.  The other keys are:
  84.  
  85. Tab     Move to start of next input field.
  86. Shift Tab  Move to start of current input field or to start of previous 
  87.            field.
  88. Home    Same as Shift Tab.
  89. End    Move to end of current input field.
  90. Ins    Toggle insert mode.
  91. Ctrl-Home    Move to start of display area.
  92. Ctrl-End    Move to end of display area.
  93. Enter    Move to next line of input field.  If in last line, move to next input
  94.         field.  If in last field, exit.
  95. Ctrl Enter    Exit
  96. Esc    Terminate MENU and do not create output files.
  97. F1    Help.  Display key definitions.
  98.  
  99. The following additional keys are defined only when using MENU /E to create or
  100. edit a screen file.
  101.  
  102. F2    The current cursor position is to be the end of the display area.
  103. F3    Display the start and end of each input field and constant field with
  104.         [] and {} respectively.  For single character fields,[] and {} are 
  105.         displayed.
  106. F4    Delete an input field or constant field.  The cursor must be on the 
  107.         start of the field.
  108. F5    Insert a start of constant field.
  109. F6    End of constant field.
  110. F7    Insert a start of an input field.  
  111. F8    End of input field.
  112. F9    Change color attributes.  The new colors are applied using F10.
  113. F10    Apply color attributes to cursor location and advance cursor.
  114. UTILITIES  Jeff Prosise               
  115.  
  116.  
  117.